package com.hnchances.studentscoresystem.dto.response;

import lombok.Data;

import java.util.List;

/**
 * 成绩分页查询响应DTO
 * 对应接口：/grades/query（有鉴权，分页场景）
 * 功能：封装分页信息 + 成绩列表
 */
@Data
public class GradesPageResponse {

    /**
     * 当前页码
     * 约束：非空（适配PageHelper分页插件）
     */
    private Integer pageNum;

    /**
     * 每页条数
     * 约束：非空（适配PageHelper分页插件）
     */
    private Integer pageSize;

    /**
     * 总记录数
     * 约束：非空（适配PageHelper分页插件）
     */
    private Long total;

    /**
     * 成绩列表（单条成绩信息由GradesQueryResponse封装）
     * 约束：可空（无数据时返回空列表）
     */
    private List<GradesQueryResponse> gradesList;
}